This pull request introduces a comprehensive Claude Code configuration
for the PetSphere Flutter project, adding project-specific automation,
code review, and code generation skills. It establishes a robust
developer workflow with automated formatting, protected file
permissions, and specialized tools for scaffolding features, components,
and tests. The most important changes are summarized below:

**Project Automation & Configuration**

- Added `.claude/settings.json` to configure automatic Dart formatting
and linting hooks after file edits, define protected files to prevent
accidental changes, and register MCP servers for Supabase database
access and real-time Flutter/Dart documentation lookup.
- Updated `.claude/settings.local.json` to expand allowed permissions
for local development, including running tests, managing git, and
interacting with Supabase MCP plugins.

**Developer Skills & Scaffolding Tools**

- Introduced `/flutter-new-component` skill to scaffold new Flutter
components following PetSphere conventions, with options for stateless,
stateful, and Riverpod consumer widgets.
- Added `/migration-helper` skill to generate a complete feature layer
(model, repository, controller) for new database-backed features,
supporting options for images, timestamps, and user relationships.
- Added `/test-writer` skill to generate unit tests for controllers,
repositories, and utilities, following arrange-act-assert and Riverpod
testing patterns.

**Code Review Automation**

- Added a dedicated code review agent (`@code-reviewer`) with a detailed
checklist for Riverpod patterns, architecture compliance, null safety,
repository pattern, error handling, and test readiness. Includes CI/CD
integration instructions.

**Documentation & Workflow**

- Created a comprehensive `.claude/README.md` documenting all
automation, skills, agents, hooks, workflow recommendations,
troubleshooting, and file organization for the PetSphere project.

These changes collectively establish a modern, automated, and
best-practice-driven workflow for PetSphere Flutter development.

- Project Automation & Configuration:
[[1]](diffhunk://#diff-f27ac6f39d89fe021c56900069198aa7d9968f2cd6645c00b11ffd1b78fcf546R1-R39)
[[2]](diffhunk://#diff-fca16cae5b0e32edfa6b55eaa32a98ffbf4a0c7d885fb585785fc83b6ea2d9c3L5-R13)
- Developer Skills & Scaffolding Tools:
[[1]](diffhunk://#diff-3db7031ba726f9cc965844d9a34aac9a7424da573eb5922354fd45854b4bcc82R1-R106)
[[2]](diffhunk://#diff-b2249c820f00fa250296bb8416bb4001269a735d64749aeb7b8d20877c1a0cceR1-R139)
[[3]](diffhunk://#diff-48e9bd17374ab37882496bebaeffd1bde6c8367789eaaf0f82b1f981181ccbacR1-R99)
- Code Review Automation:
[.claude/agents/code-reviewer.mdR1-R126](diffhunk://#diff-c0a2150c92b282c9817c6c5f7ebaec0c020d45e9aeedff28f8c49e21c09cafebR1-R126)
- Documentation & Workflow:
[.claude/README.mdR1-R258](diffhunk://#diff-2299e67d57e898bc0991b42cf6a33a56497600bfbc83191d4a1438c6d5aa13b4R1-R258)